.TH E1432_ARM_MEASURE 3 E1432
.SH NAME
e1432_arm_measure \- Manually arm, move E1432s from IDLE to ARM state
.IX e1432_arm_measure(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_arm_measure(E1432ID hw, SHORTSIZ16 ID,
                             SHORTSIZ16 wait_after)
.cE
.SH DESCRIPTION
\fIe1432_arm_measure\fR moves all modules in the group from the \fBIDLE\fR
state to the \fBARM\fR state.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

This function performs a "manual arm", and does not need to be called
when the group is set to "auto arm".  This function is called for the
first time after \fIe1432_init_measure\fR, and then, when in block
mode, after each data block has been read out of the module.  See the
"Measurement setup and control" section earlier in this manual, for a
detailed description of the measurement states.

This function waits for all modules to be in the \fBIDLE\fR state,
before proceeding further, and it will return an error if this state
is not reached after a limited time.  After the call to
\fIe1432_arm_measure\fR completes successfully, the measurement will
proceed further, as the trigger event occurs (see
\fIe1432_trigger_measure\fR).

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.  If the measurement involves more than one module, it is
mandatory that a \fIgroup ID\fR be used, rather than a \fIchannel
ID\fR.

\fIwait_after\fR determines whether this function will wait for the
module to actually move beyond the \fBARM\fR state.  If zero, the
function does not wait; if non-zero, the function waits.

.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_init_measure, e1432_trigger_measure,
e1432_arm_measure_master_finish
.ad
